home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / macros / text1 / cms_help_files / bif.helpmark < prev    next >
Text File  |  1991-10-23  |  13KB  |  249 lines
  1. +-----------------------------------------------------------------------------+
  2. |                             bibliographyformat                              |
  3. +-----------------------------------------------------------------------------+
  4.  
  5. Abbreviation:  π|\bifπ%
  6.  
  7. Parameters:    π|submarkupπ%
  8.  
  9. Submarkup:     π|\incontents, \titleformat, \everybibentry,
  10. \sameauthorrulesizeπ%
  11.  
  12.     π|Description:π%
  13. The   \bibliographyformat  markup   controls   the  style   of   the  entire
  14. bibliography.  The following submarkup is only valid within \bif.
  15.  
  16. \incontents  by default adds the title text to the contents.  The default is
  17. yes; to keep the title from appearing enter "no":
  18.  
  19. \bibliographyformat{\incontents{no}}
  20.  
  21. \titleformat{Nested Markup}  controls  the format of the bibliography title.
  22. The default skips  to a new page,  centers the title in  bold, and skips one
  23. line.  You may  use markup such as \newpage, \verticalspace, and \centerline
  24. within \titleformat  as Nested Markup.   Other markup you  may use within or
  25. outside of \bibliographyformat:
  26.  
  27.   * \bibtitleprints the title entered with the \bibliography markup.
  28.  
  29. \everybibentry{Nested  Markup}   controls the  format of  each bibliographic
  30. entry.   The default permits breaking between  entries and creates a hanging
  31. paragraph  for the  entry.    You  may  use markup  such  as \verticalspace,
  32. \hangingparagraph, \item, \goodbreak,  \noindent, \label, \leftindent within
  33. \everybibentry as Nested Markup.  Other markup you may use within or outside
  34. of \bibliographyformat:
  35.  
  36.   * \bibnumberprints the current \bibentry number.
  37.  
  38. \sameauthorrulesize  sets the height,  width, and depth of a horizontal line
  39. used to indicate a repeat of an author's name.
  40.  
  41.     π|Example:π%
  42. The following markup  produces entries similar to  the default but numbered.
  43. A period and  a tie (tilde, for  a connecting space) join  the number to the
  44. text.
  45.  
  46. \bibliographyformat{\incontents{yes}
  47.         \titleformat{\np
  48.                       \cl{\bd \bibtitle}
  49.  
  50.                       \vs{\bl}
  51.                       }
  52.    \everybibentry{\goodbreak\hp\nin\bibnumber.~}
  53.    \sameauthorrulesize{width3em height.6ex depth-.5ex}
  54. }
  55.  
  56. Then when you use \bibentry, you would get:
  57. +-----------------------------------------------------------------------------+
  58. |                                                                             |
  59. | 1.  Grabens,   Gruss  M.  1970.      Mechanical  Processes  in  the  Human  |
  60. |    Geomechanism.  Winston:  Geomedical Publications, International.         |
  61. | 2. Illite, Ivan.  1911.  "Picking the Philosopher's Stone."  Mining Truth.  |
  62. |    11:455--601.                                                             |
  63. | 3. Moraine, Esker.   1978.   "Pet rocks as therapy  tools."  Geopsychology  |
  64. |    Today.  10:71--78.                                                       |
  65. | 4. Salt,  Jean-Paul.    1958.   Gravel  and  Nothingness:   An Existential  |
  66. |    Theory.  Dayton:  Gabbro Press.                                          |
  67. |                                                                             |
  68. +-----------------------------------------------------------------------------+
  69.  
  70.     π|Example:π%
  71. This example  also numbers  entries, but it  uses labels  instead of hanging
  72. paragraphs.   The \labelformat is changed  under \titleformat to accommodate
  73. numbers.   This layout is useful for  bibliographies that use identifiers in
  74. place of numbers.
  75.  
  76. \bibliographyformat{\incontents{yes}
  77.         \titleformat{\np\vsk{1in}
  78.                       \cl{\bd \bibtitle}
  79.                       \vs{\bl}
  80.                       \labelformat{\labelwidth{22pt}}}
  81.    \everybibentry{\goodbreak\label{\bibnumber}}
  82.    \sameauthorrulesize{width3em height.6ex depth-.5ex}}
  83.  
  84. Then when you use \bibliography, you would get:
  85. +-----------------------------------------------------------------------------+
  86. |                                                                             |
  87. |                                 References                                  |
  88. |                                                                             |
  89. | 1.  Grabens,  Gruss   M.  1970.     Mechanical   Processes  in  the  Human  |
  90. |     Geomechanism.  Winston:  Geomedical Publications, International.        |
  91. |                                                                             |
  92. | 2.  Salt,  Jean-Paul.   1958.    Gravel and  Nothingness:   An Existential  |
  93. |     Theory.  Dayton:  Gabbro Press.                                         |
  94. |                                                                             |
  95. +-----------------------------------------------------------------------------+
  96.  
  97.     π|Example:π%
  98. You can specify in the  \everybibentry markup that the bibentry number is to
  99. be surrounded by parenthesis or square brackets.
  100.                \everybibentry{\goodbreak\label{(\bibnumber)}}
  101. +-----------------------------------------------------------------------------+
  102. |                                                                             |
  103. |                                 References                                  |
  104. |                                                                             |
  105. | (1) Grabens,  Gruss   M.  1970.     Mechanical   Processes  in  the  Human  |
  106. |     Geomechanism.  Winston:  Geomedical Publications, International.        |
  107. |                                                                             |
  108. | (2) Salt,  Jean-Paul.   1958.    Gravel and  Nothingness:   An Existential  |
  109. |     Theory.  Dayton:  Gabbro Press.                                         |
  110. |                                                                             |
  111. +-----------------------------------------------------------------------------+
  112.  
  113.     π|Example:π%
  114. You could also  use \label to indicate citations  that carry an alphanumeric
  115. label by omitting the parameter to \label in the \everybibentry markup.
  116.  
  117. \bibliographyformat{\titleformat{\np\cl{\bd \bibtitle}
  118.                       \vs{\bl}
  119.                       \labelformat{\labelwidth{50pt}}}
  120.    \everybibentry{\goodbreak\label}
  121.    \sameauthorrulesize{width3em height.6ex depth-.5ex}}
  122.  
  123. Then use the \bibentry markup as though it had a parameter:
  124.  
  125. \bibliography{Citations}\frenchspacing
  126. \bibentry {Grabe70}
  127. Grabens, Gruss M. 1970. {\it Mechanical Processes
  128. in the Human Geomechanism}. Winston: Geomedical
  129. Publications, International.
  130. \bibentry{Illit11}
  131. Illite, Ivan. 1911. "Picking the Philosopher's
  132.  
  133. Stone." {\it Mining Truth}. 11:455--601.
  134. \bibentry{Morai78}
  135. Moraine, Esker. 1978. "Pet rocks as therapy tools."
  136. {\it Geopsychology Today}. 10:71--78.
  137.  
  138. and the citations will look like:
  139. +-----------------------------------------------------------------------------+
  140. |                                                                             |
  141. |                                  Citations                                  |
  142. |                                                                             |
  143. | Grabe70 Grabens,  Gruss  M. 1970.     Mechanical  Processes  in the  Human  |
  144. |         Geomechanism.  Winston:  Geomedical Publications, International.    |
  145. |                                                                             |
  146. | Illit11 Illite, Ivan.   1911.  "Picking the Philosopher's  Stone."  Mining  |
  147. |         Truth.  11:455--601.                                                |
  148. |                                                                             |
  149. | Morai78 Moraine,  Esker.      1978.     "Pet   rocks  as  therapy  tools."  |
  150. |         Geopsychology Today.  10:71--78.                                    |
  151. |                                                                             |
  152. +-----------------------------------------------------------------------------+
  153.  
  154.     π|Example:π%
  155. Another popular  style groups all of  an author's citations together.   This
  156. can  be  accomplished in  a  similar  manner as  previously  defined.    The
  157. difference being that the \rt markup is used.
  158.  
  159. \bibliographyformat{\titleformat{\np\vsk{1in}
  160.                       \cl{\bd \bibtitle}
  161.                       \vs{\bl}
  162.                       \labelformat{\labelwidth{50pt}}}
  163.    \everybibentry{\goodbreak\label}
  164.    \sameauthorrulesize{width3em height.6ex depth-.5ex}}
  165. \bibliography{Citations}\frenchspacing
  166. \vs{.5\bl}
  167. \nin OSBORNE, J.S.
  168. \bie{\rt{1971.}}
  169. {\it Introduction to Aesthetic Anthropology}. Boston, Ma:
  170. Addison-Wesley Pub. Co.
  171. \bie{\rt{1978.}}
  172. A survey of tribal masks used by Brazilian tribes.
  173.  
  174. Pages 160--169 in {\it Cultural Anthropology}.
  175. M. Zateh and F. Grange, eds. New York: Harper and Row.
  176. \vs{.5\bl}
  177. \nin OTTEN, C.M.
  178. \bibentry{\rt{1971.}}
  179. {\it Anthropology and Art: Readings in Cross Cultural
  180. Aesthetics}. Garden City, N.Y.:
  181. The Natural History Press.
  182.  
  183. and the citations will look like:
  184. +-----------------------------------------------------------------------------+
  185. |                                                                             |
  186. |                                  Citations                                  |
  187. |                                                                             |
  188. | OSBORNE, J.S.                                                               |
  189. |                                                                             |
  190. |   1971. Introduction to Aesthetic Anthropology. Boston, Ma: Addison-Wesley  |
  191. |         Pub. Co.                                                            |
  192. |                                                                             |
  193. |   1978. A survey of tribal masks used  by Brazilian tribes. Pages 160--169  |
  194. |         in Cultural Anthropology.  M. Zateh and F.  Grange, eds. New York:  |
  195. |         Harper and Row.                                                     |
  196. | OTTEN, C.M.                                                                 |
  197. |                                                                             |
  198. |   1971. Anthropology  and  Art:  Readings in  Cross  Cultural  Aesthetics.  |
  199. |         Garden City, N.Y.: The Natural History Press.                       |
  200. |                                                                             |
  201. +-----------------------------------------------------------------------------+
  202.  
  203.     π|Example:π%
  204. This final style makes use of  an \everybibentry similar to the default.  In
  205. this example, the paragraph and  hanging indents are set to different values
  206. (by default  they are  equal).   The other  difference is that  \noindent is
  207. omitted.
  208.  
  209. \bibliographyformat{\titleformat{\np\cl{\bd \bibtitle}
  210.                       \vs{\bl}
  211.                       \psk{\bl}\pin{10pt}\hin{20pt}}
  212.    \everybibentry{\par\goodbreak\hp\indent}
  213.    \sameauthorrulesize{width3em height.6ex depth-.5ex}}
  214. \bibliography{Bibliography}\frenchspacing
  215. \vs{\bl}  \nin Asher67
  216. \bie
  217. Asherson, G. L., and S. H. Stone. 1967.\linebreak
  218. Dessensitization {\it in vitro}. {\it Immunology}.
  219. 13:469. {\it Cultural Anthropology}. M. Zateh and
  220. F. Grange, eds. New York: Harper and Row.
  221. \vs{\bl}
  222. \nin Cinad68
  223.  
  224. \bie
  225. Cinader, B., editor. 1968.\lbr
  226. Regulation of the Antibody Response. Charles C. Thomas,
  227. Publisher, Springfield, Ill.
  228.  
  229. and the citations will look like:
  230. +-----------------------------------------------------------------------------+
  231. |                                                                             |
  232. |                                Bibliography                                 |
  233. |                                                                             |
  234. | Asher67                                                                     |
  235. |  Asherson, G. L., and S. H. Stone. 1967.                                    |
  236. |    Dessensitization in  vitro. Immunology. 13:469.  Cultural Anthropology.  |
  237. |    M. Zateh and F. Grange, eds. New York: Harper and Row.                   |
  238. |                                                                             |
  239. | Cinad68                                                                     |
  240. |  Cinader, B., editor. 1968.                                                 |
  241. |    Regulation of  the  Antibody Response.  Charles  C.  Thomas, Publisher,  |
  242. |    Springfield, Ill.                                                        |
  243. |                                                                             |
  244. +-----------------------------------------------------------------------------+
  245.  
  246.     π|Notes:π%
  247. The \bibliographyformat  markup must  come after  the \monospace  markup, if
  248. both are used.
  249.